home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / networking / info-service / gopher / Unix / GopherTools / glog / glog30.readme < prev    next >
Encoding:
Text File  |  1993-06-08  |  2.7 KB  |  77 lines
  1. Announcing Gopher LOG 3.0 
  2.    Andy Wick - awick@csugrad.cs.vt.edu
  3.  
  4. Original version by
  5.    Chuck Shotton - cshotton@oac.hsc.uth.tmc.edu
  6.  
  7. 3.0 is almost a total rewrite of the original, with old ideas
  8. from the original, and some new ones of my own.  I tried to make it easier
  9. to get the type of reports that I wanted.  About the only thing
  10. missing that 2.3 could do, is printing reports without the hits
  11. field sorted.
  12.  
  13. I have tested 3.0 with purify and can report there are no memory leaks/bugs
  14. what so ever (at least when I use it :).  The program is very memory hungry
  15. though, you need about 1.5 times the size of the log file of memory.  This
  16. is because the log file is completely parsed and stored in memory 
  17. at startup. You can lower that amount if you compile without the DETAIL 
  18. option, see "glog30.c".
  19.  
  20. How to use:
  21.  glog30 -h will display the options :).  But as a short example.  
  22.  
  23.  How to create a [H]ost report, a [D]ata report with detail of [H]osts and
  24.  width of 132, and a plot of [T]ypes with basename of "test".  The log file
  25.  is called gopher.log.  Don't forget, reports always go to stdout.
  26.  
  27.  % glog30 -H -w 132 -DH -f test -pT < gopher.log | more
  28.  
  29. Tested on:
  30.  gcc 2.3.3 was used on all platforms.
  31.  Amiga DOS (main development), SunOS 4.1.3 (purify 2.0.3), Ultrix 4.2A
  32.  
  33. New Features:
  34.  * The command line is parsed as the reports/plots are generated, so that
  35.    it is possible to change options for each separately.  But options
  36.    are NOT reset for each new one.
  37.  
  38.  * It now can produce reports on the [D]ata, [H]osts, day of the [W]eek,
  39.    data [T]ypes, and [M]onth/date sorted (ie. sorted by date).
  40.  
  41.  * It can now produce detail reports on any thing you can produce a normal
  42.    a report for.  Yes, you can even produce a host detail report of a 
  43.    hosts report. (But it doesn't do you much good :)
  44.  
  45.  * Change the width of the reports.
  46.  
  47.  * You can specify the filename for plots, it defaults to gopher. (The 
  48.    program appends a .dat, and and .run to the name)
  49.  
  50.  * You can request as many plots as you want. (But remember to change the
  51.    filename or you will overwrite the last plot)
  52.    
  53.  * The program is now a lot easier to add new types of reports to, you
  54.    only need to add 3 short routines, a variable, and edit 2 functions.
  55.    (Well, maybe it is simple for me. :)
  56.  
  57. TODO:
  58.  * Fix up plots some more: add histograms, and more options.
  59.  
  60.  * option for how detail works (which way should it work?)
  61.  
  62.  * Someone will probably want to have the hits field unsorted, and I will
  63.    need to hack a way to do that.
  64.  
  65.  * Make it so reports can go to files.
  66.  
  67.  * Make some documentation
  68.  
  69.  * Improve error checking
  70.  
  71.  
  72. PLUG:
  73.  Purify! Purify! Purify!
  74.  If you don't have it, get it.
  75.  
  76. If anyone has any ideas or suggestions please send them to me.
  77.